Installing the License Reporting Tool

The License Reporting Tool (LRT) includes various reports. To run the reports, you must install it using the instructions below.

Prerequisites

LRT requires the following on the Automation Engine system:

• A Windows or Linux operating system with Java 8 installed.

Hint for Java 7 Users: LRT requires Java 8. In case you need to keep the Java 7 runtime on your system for compatibility purposes, you can install Java 8 without removing Java 7. To invoke lrt.jar with the Java 8 runtime, simply prefix the lrt.jar invocations with the path to your Java 8 runtime. For example: c:\path_to_java8\bin\java.exe -jar lrt.jar. For more information, consult the Java 8 documentation.

• The Automation Engine database you wish to generate usage reports for is hosted on the same system or is reachable via network.
• A suitable JDBC driver for your Automation Engine database.

Installation Steps (Windows)

1. Download the LRT tool from the Automic Download Center.
2. Extract it to a suitable LRT sub-directory, such as C:\Automic\Tools\LRT.
3. Extract a copy of the .jar file for your downloaded JDBC driver to the folder \cli\windows\bin\lib (for example, C:\Automic\Tools\LRT\cli\windows\bin\lib).
4. Adapt the settings in the [JDBC] section of \cli\windows\bin\lrt.ini file and optionally any of the other settings.

Sections and parameters of the lrt.ini file are described in Configuring the License Reporting Tool.

5. Open a cmd prompt, navigate to your \cli\windows\bin sub-directory and start LRT with java -jar lrt.jar to view the command line usage screen.

All further options are described in Using the License Reporting Tool.

Installation Steps (UNIX)

1. Download the LRT tool from the Automic Download Center.
2. Extract and transfer them to a suitable LRT sub-directory, such as /Automic/Tools/LRT.
3. Navigate to your /cli/unix sub-directory and unpack the license_usage_reporting_tool.tar.gz file using: 

gzip -d license_usage_reporting_tool.tar.gz

tar xvf license_usage_reporting_tool.tar

or

tar -zxvf license_usage_reporting_tool.tar.gz

4. Extract a copy of the .jar file for your downloaded JDBC driver to the sub-directory /cli/unix/bin/lib (for example, /Automic/Tools/LRT/cli/unix/bin/lib).
5. Adapt the settings in the [JDBC] section of /cli/unix/bin/lrt.ini file and optionally any of the other settings.

Sections and parameters of the lrt.ini file are described in Configuring the License Reporting Tool.

6. Navigate to your /cli/unix/bin sub-directory and start LRT with java -jar lrt.jar to view the command line usage screen.

All further options are described in Using the License Reporting Tool.